Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Compatibility Messages

GXConvertPrintRecordFrom

QuickDraw GX sends the GXConvertPrintRecordFrom message when an application that supports the Macintosh Printing Manager calls the GXConvertPrintRecordFrom function, which converts a print record into a driver-specific format. You can override the GXConvertPrintRecordFrom message to customize the handling of the GXConvertPrintRecordFrom function. Your override of the GXConvertPrintRecordFrom message must match the following formal declaration:

OSErr MyConvertPrintRecordFrom (THPrint aTHPrint);

aTHPrint

A handle to the print record for this printing operation.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

The default implementation of the GXConvertPrintRecordFrom message does nothing. Your override fills in the print record with information from the job collection.

SPECIAL CONSIDERATIONS

You never send the GXConvertPrintRecordFrom message yourself.

You need to totally override the GXConvertPrintRecordFrom message to support your Macintosh Printing Manager print-record format.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The GXConvertPrintRecordFrom function is described in Inside Macintosh: QuickDraw GX Printing.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help